NAME¶

bos_getrestricted - Displays whether a bos server is restricted or not

SYNOPSIS¶

bos getrestricted -server <machine name> [-cell <cell name>]
[-noauth] [-localauth] [-help]

DESCRIPTION¶

The bos getrestricted command shows whether the server machine named by the -server argument is running in restricted mode.

Restricted mode limits access to certain bos commands. See bos_setrestricted(8) for details of which commands are disabled by restricting a server.

Use the bos setrestricted command to restrict, or un-restrict, a server.

OPTIONS¶

-server <machine name>

Indicates the server machine for which to display the restart times. Identify the machine by IP address or its host name (either fully-qualified or abbreviated unambiguously). For details, see bos(8).

-cell <cell name>

Names the cell in which to run the command. Do not combine this argument with the -localauth flag. For more details, see bos(8).

-noauth

Assigns the unprivileged identity "anonymous" to the issuer. Do not combine this flag with the -localauth flag. For more details, see bos(8).

-localauth

Constructs a server ticket using a key from the local /usr/afs/etc/KeyFile file. The bos command interpreter presents the ticket to the BOS Server during mutual authentication. Do not combine this flag with the -cell or -noauth options. For more details, see bos(8).

-help

Prints the online help for this command. All other valid options are ignored.

OUTPUT¶

The output consists of a single line

   Restricted mode is <val>

Where <val> is "on" or "off"

PRIVILEGE REQUIRED¶

None

SEE ALSO¶

BosConfig(5), bos(8), bos_setrestricted(8)

COPYRIGHT¶

Copyright 2009 Simon Wilkinson <simon@sxw.org.uk>

This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Simon Wilkinson for OpenAFS.